Golang Zakhireh – local Go proxy for offline use

Local go module proxy. Offline-first. Air-gapped. Sanctioned-country friendly.

Problem

• go mod download fails on bad net?
• Firewall blocks proxy.golang.org?
• No internet at all?
• This fixes it.

Runs locally. Caches modules on disk. Serves forever offline.

Why I Built It

• Corporate firewalls suck.
• Air-gapped labs.
• Sanctioned countries (Iran, China, etc.) — upstream proxies often blocked or unreachable.
• Athens and gomods.io? Powerful but heavy.
  • Need docker-compose, config files, storage backends, sometimes databases.
  • Too much for quick local setup or low-resource machines.

This Is Different

• Single binary. Minimal deps. Hackable.
• Seed once on connected machine → copy cache → run offline forever.
• No cloud. No external services. Just HTTP server.

Main Features

• Tiny dashboard: http://localhost:8811 — list modules, versions, sizes
• Manual upload: drop private .zip, .mod, .info via UI or curl /upload
• GONOSUMDB support built-in
• Allow/deny lists: GOLANGZAKHIREH_ALLOW, GOLANGZAKHIREH_DENY
• Upstream fallback (default proxy.golang.org) — disable for pure offline

Quick Start (Connected Machine)

      

        bash
        [cpy]
      
git clone https://github.com/GolangZakhireh/golang_zakhireh
cd golang_zakhireh
go run ./cmd/server

Set Go proxy:

      

        bash
        [cpy]
      
export GOPROXY=http://localhost:8811/proxy,direct
go get github.com/gin-gonic/gin

Dashboard shows cache. Download happens from upstream first time.

Config Environment Variables

      

        bash
        [cpy]
      
export GOLANGZAKHIREH_PORT=:9000
export GOLANGZAKHIREH_DATA_DIR=/var/cache/go-modules
export GOLANGZAKHIREH_UPSTREAM=https://goproxy.io   # or empty for no upstream
export GONOSUMDB=github.com/mycompany/*
export GOLANGZAKHIREH_ALLOW=github.com/myorg/*
export GOLANGZAKHIREH_DENY=badmodule/*

Sanctioned Countries Offline Workflow

1. Use connected machine (VPN or outside sanctions). Run proxy. go get everything your projects need. Cache fills ./data/modules.
2. Copy whole data/modules dir to USB/drive.
3. On offline/sanctioned machine: place data/modules at your DATA_DIR. Start proxy.
4. Set GOPROXY=http://localhost:8811/proxy,direct
   • (No upstream needed — set to empty or invalid if paranoid)
5. go build / go test / go mod tidy works fully locally.

Private Modules? Upload via Dashboard or Curl

Example:

      

        bash
        [cpy]
      
curl -X POST http://localhost:8811/upload \
  -F "module=github.com/mycompany/private" \
  -F "version=v1.0.0" \
  -F "info=@v1.0.0.info" \
  -F "mod=@v1.0.0.mod" \
  -F "zip=@v1.0.0.zip"

Docker

      

        bash
        [cpy]
      
docker-compose up -d

Mounts to ./data/modules persistent directory.

Why Use This?

Simple. Lightweight. No BS deps.
Works where Athens is overkill or blocked.

• GolangZakhireh/golang_zakhireh – GitHub

Utils Repository

Scrapes Awesome-Go. Gets categories + latest versions. Dumps to txt/csv.

• Workflow:

  1. Run on connected machine → get list → pre-download popular modules → copy cache over.
  2. Saves time seeding.

• GolangZakhireh/golang_zakhireh_utils – GitHub